home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / fidoq118.zip / FIDOQWK.DOC < prev    next >
Text File  |  1993-07-17  |  17KB  |  491 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                               FidoQWK v1.18 (July 17, 1993)
  11.                           FidoNet(tm) <=> QWK echomail processor
  12.                              Copyright (C) 1992,3 Geoffrey Sy
  13.                                    All Rights Reserved
  14.  
  15.  
  16.               FidoQWK is supported by:
  17.  
  18.                Geoffrey Sy                       Toronto Twilight Comm.
  19.                14 Blevins Pl Unit 1322           1-416-733-9012
  20.                Toronto, On  M5A 3M5              Join conference #16
  21.                Canada
  22.  
  23.               ═════[INTRODUCTION]══════════════════════════════════════════
  24.                                                                           
  25.               FidoQWK is for anyone running a FidoNet compatible BBS system
  26.               and wants to carry any .QWK type nets or vice versa.   It can
  27.               also be used for QWK door to QWK door mail transfer.
  28.  
  29.               The basic concept for FidoNet *.MSG <=> QWK transfer:
  30.  
  31.                  FidoNet *.MSG => BBS_ID.REP => QWK Mail door =>
  32.                  QWK mail door => BBS_ID.QWK => FidoNet *.MSG
  33.  
  34.               Additional step(s) may be required to convert from your BBS's
  35.               native message format into  the standard FidoNet *.MSG format
  36.               and vise versa.  
  37.  
  38.               If  Fido *.MSG  is not  desirable, FidoQWK  also support  the
  39.               FidoNet type 2 packet format in  either StoredMail or ArcMail
  40.               format, I'll refer  to this format as  .PKT here.  The  basic
  41.               concept for .PKT <=> QWK transfer follows:
  42.  
  43.                  FidoNet .PKT  => BBS_ID.REP => QWK Mail door =>
  44.                  QWK mail door => BBS_ID.QWK => FidoNet .PKT
  45.  
  46.               For situations where  a QWK  mail door is  available on  both
  47.               BBS, QWK2REP will allow mail transfers between the doors:
  48.  
  49.                  HOSTBBS.QWK => THISBBS.REP => This BBS mail door =>
  50.                  THISBBS.QWK => HOSTBBS.REP => Host BBS mail door
  51.  
  52.               In  this documentation I'm assuming  that you know  how to do
  53.               this as well as the basic concept of echomail transfers.   If
  54.               you  are  not  sure,  leave  a  message  on  the  appropriate
  55.               conference  on  the  echo,  the  SysOps  conference  on  most
  56.               echomail network is usually appropriate.
  57.                                                            
  58.  
  59.  
  60.  
  61.               _____________________________________________________________
  62.               FidoQWK echomail processor documentation ................. 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.               ═════[OVERVIEW]══════════════════════════════════════════════
  71.                                                                            
  72.               There  are 5 modules to the FidoQWK package.  There's FQSETUP
  73.               that sets up the needed data for the other modules.  
  74.  
  75.               The  MSG2REP module packs the  *.MSG files into  a REP packet
  76.               for uploading to a QWK mail door.  The QWK2MSG module unpacks
  77.               the QWK  packet and tosses  *.MSG files into  the appropriate
  78.               message areas.  The PURGE module  is used to delete all *.MSG
  79.               files in the message areas.
  80.  
  81.               The QWK2REP module  allows conversion of one  BBS's .QWK mail
  82.               packet  into another BBS's .REP  packet.  It  lets BBSes with
  83.               QWK  mail  doors to  exchange  messages  in situations  where
  84.               echomail processors for the BBSes don't exist.
  85.  
  86.               In summary:
  87.  
  88.                    FQSETUP.EXE  - Sets up data files for all modules.
  89.  
  90.               For Fido *.MSG <=> QWK, the following modules are needed:
  91.  
  92.                    MSG2REP.EXE  - Packs *.MSG into a REP packet for sending
  93.                                   out to the host BBS.
  94.                    QWK2MSG.EXE  - Inserts messages from the host BBS into
  95.                                   your BBS.
  96.                    PURGE.EXE    - Wipes out all *.MSG files for a BBS.
  97.  
  98.               For FidoNet .PKT <=> QWK, the following modules are needed:
  99.  
  100.                    PKT2REP.EXE  - Converts FidoNet .PKT  into a REP  packet
  101.                                   for sending to the QWK mail door.
  102.                    QWK2PKT.EXE  - Convert QWK to FidoNet .PKT.
  103.  
  104.               For QWK door <=> QWK door:
  105.  
  106.                    QWK2REP.EXE   - Converts .QWK  packet from one  BBS to a
  107.                                   .REP  packet  for  uploading  to  another
  108.                                   BBS's QWK mail door.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.               _____________________________________________________________
  123.               FidoQWK echomail processor documentation ................. 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.               ═════[FQSETUP]═══════════════════════════════════════════════
  133.  
  134.               When FQSETUP is executed a menu with 3 options will be shown.
  135.               If  the help system  was completed, the  F1 key  calls up the
  136.               context-sensitive help items.  Option 'A' sets up the general
  137.               information.  These general information includes:
  138.  
  139.                  1 - Your name
  140.                  2 - Registration key (if you're registered)
  141.                  3 - Serial number    (if you're registered)
  142.  
  143.                  4 - The location where you want FidoQWK to send the 
  144.                      BBS_ID.REP package.
  145.                  5 - The location where you've downloaded the host BBS's   
  146.                      BBS_ID.QWK mail package.
  147.                  6 - The location where FidoQWK can store its temporary 
  148.                      work files.  A RAM or fast hard disk is recommended.
  149.                  7 - The location to store inbound FidoNet .PKT packets.
  150.                  8 - The location to store outbound FidoNet .PKT packets.
  151.  
  152.               Option 'B' sets up the data compressor characteristics.  Each
  153.               compressor definition requires the following information:
  154.  
  155.                  1 - The make and model of the compressor
  156.                  2 - The full pathname (including extension) and switches 
  157.                      needed to compress a file.
  158.                  3 - The full pathname (including extension) and switches 
  159.                      needed to de-compress a file.
  160.                  4 -  The ASCII value of the first byte found in files that
  161.                      have been compressed with  this compressor.  This will
  162.                      be used for detection of the compressed file type.
  163.                    (* NOTE: Automatic detection of compressed file type has
  164.                            not yet been programmed into v1.00 of FidoQWK *)
  165.  
  166.               Option  'C' sets up  host BBS information  and message bases.
  167.               These options include:
  168.  
  169.                  1 - The name of the .QWK packet (Host ID).
  170.                  2 - The BBS name of the host.
  171.                  3 - The tagline of the host BBS to be placed on all 
  172.                      incoming messages.
  173.                  4 - The compressor type used on this BBS.
  174.  
  175.                  5 - The tagline to be placed on all outgoing messages.
  176.  
  177.               There  may  be  features not  documented  here,  press  F1 in
  178.               FQSETUP to display additional help.  To insert more host BBS,
  179.               press Alt-I.  To delete a host BBS, press Alt-D.  To locate a
  180.               host BBS, press F4.   To repeat the same data for a  new BBS,
  181.               press  Alt-D.   The Page  Up and Page  Down keys  selects the
  182.  
  183.               _____________________________________________________________
  184.               FidoQWK echomail processor documentation ................. 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.               previous and next host BBS. Press the F2 key at anytime while
  193.               under  option 'C' to edit  the message base  names and paths.
  194.               These include:
  195.  
  196.                  1 - The conference number used on the host BBS.
  197.                  2 - The name of the message area.
  198.  
  199.                  3 - The location on your hard drive to store these   
  200.                      messages.
  201.                  4